home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
Collection of Tools & Utilities
/
Collection of Tools and Utilities.iso
/
tex
/
jdic23.zip
/
JREADR23.DOC
< prev
next >
Wrap
Text File
|
1993-07-01
|
17KB
|
353 lines
J R E A D E R
Japanese Text Reader with Online Dictionary Search & Yomikata Lookup
====================================================================
Version 2.3
J.W. Breen
May 1993
CONTENTS
1. INTRODUCTION
2. THIS DOCUMENT
3. INSTALLATION
4. ENVIRONMENT
5. OPERATION
6. DICTIONARY SEARCHING
7. VERB & ADJECTIVE MODIFICATION
8. YOMIKATA SEARCHING
9. KANJI INFORMATION
10. ADDITIONS TO PREVIOUS VERSION(S)
11. AUTHOR'S COMMENT
1. INTRODUCTION
---------------
This program provides a capability to display a text file containing Japanese
characters (kana & kanji) with the option of looking up displayed words in a
Japanese/English dictionary file or in MOKE's kanji-to-kana yomikata file.
The Japanese characters in the text files can either be in the EUC, New-JIS,
Old-JIS or Shift-JIS codes. In the case of EUC and Shift-JIS, hankaku codes
are not supported. A file containing other codes, such as NEC-JIS, etc., can be
concerted into one of the supported codes using utilities such as "jc" and
"jconv".
Although JREADER is intended to help non-Japanese people read Japanese language
text files, it can also be used by Japanese to read English text. Its
usefulness in this role is limited by the dictionary, which is more oriented to
the Japanese to English mode, and the fact that the dictionary search cannot
cope with things like English's "strong" verbs (swim/swam/swum, be/am/are,
go/went, etc.).
JREADER is an extension of the author's JDIC (Japanese/English Dictionary
Display) program, which has been designed specifically to operate on a
dictionary in the "EDICT" format originally used by the MOKE (Mark's Own Kanji
Editor) Japanese text editor. As with JDIC, JREADER's operating environment
has been designed to be similar to MOKE's, and it can use the same environment
variables and control file as MOKE. Along with JDIC, it will be updated to
track MOKE versions (at present it is aligned with the MOKE V2.1.)
The executable code and documentation of JREADER is hereby released to the
"public domain". All usage of this program is at the user's risk, and there is
no warranty on its performance.
All the Japanese displayed is in kana and kanji, so if you cannot read at least
hiragana and katakana, this program will not be much use for you. The author
has NO intention of producing a version using romanized Japanese.
2. THIS DOCUMENT
----------------
JREADER is an extension of JDIC, and shares a similar operating method as JDIC.
Consequently this document file only includes details of where JREADER differs
from JDIC. Please make sure you have and read the appropriate JDICnn.doc file.
3. INSTALLATION
---------------
This program is distributed in a "zoo" archive (jdic23.zoo). Both JDIC and
JREADER share a common operating environment. Please follow the installation
details in JDIC23.DOC, which is in the "JDIC23.ZOO" file.
In addition, to get the full function from JREADER, you should have the files
WSKTOK.DAT and WSKTOK.IND. These are the kanji_to_kana file from MOKE and its
index file. Without them the "y" (yomikata lookup) function will not operate.
If you are a MOKE user (Version 2.0 or later) you will have them.
The author has produced an expanded form of the WSKTOK.DAT file by adding in
the additional entries in EDICT, plus further entries from the full WNN
dictionary. This is available in the WSKWNN.ZOO file, along with a matching
WSKTOK.IND index file.
(For the curious, there is an explanation of these files in an Appendix to
JDIC23.DOC.)
4. ENVIRONMENT
--------------
JREADER uses the same environment variables and JDIC.RC/MOKE.RC fields as JDIC
(and MOKE). These affect things like paths and colours. See JDIC23.DOC for
details.
In addition, JREADER has one special (optional) entry in the JDIC.RC/MOKE.RC
file. The verb/adjective deinflection function (see below) can be disabled by
the following line in JDIC.RC/MOKE.RC:
jverb off
The default is for this option to be enabled.
5. OPERATION
------------
(a) LOADING
JREADER is simple to operate. The command-line invocation is:
jreader <options> text-file(s)
The same -l, -f, -cDIR and -bnn options are used as in JDIC. In addition,
JREADER uses:
-sn (3 < n < 8) specifies that the text window is to use n/10 of the screen,
The default is n = 7.
-ddictionary-file specifies the file that is to be used as the dictionary,
along with an index file with an extension of ".jdx". This
latter file must be created using the JDXGEN utility. The
default is "edict" with "edict.jdx" as the index file, or
"jtoe.dct" and "jtoe.jdx", whichever is present.
-Llogfile specifies the name of a file to log possible new "edict" entries.
The default name is "jreader.log".
One or more file names can be provided. MS-DOS wildcards can be used also.
(b) READING FILES
The working screen of JREADER contains two windows. The upper displays the text
being read, the lower displays control information, and the dictionary and
yomikata search results.
The first screenful of the text file is displayed when the program starts. From
then on most operation is by single keystroke commands. They are:
<PgDn> reads the next screen of the file. The last line of the previous screen
is repeated as the first line of the next.
<PgUp> reads the previous screen of the file. The backspacing technique
involves backspacing the number of lines on the current screen, so it should
usually result in the previous screen being displayed, unless there are a
number of "folded" lines.
<Ctrl-PgUp> restarts the file from the beginning.
<Ctrl-PgDn> skips to the end of the file, and displays the last 10 lines.
<Arrow> The four arrow keys can be used to position the cursor under a
character which may be used as the start of a key for a dictionary search. A
down-arrow while on the last line causes the display to scroll down one line,
and an up-arrow on the first line causes an upwards scroll.
<Enter> positions the cursor at the start of the next line.
<End> positions the cursor at the end of the current line.
<Home> positions the cursor at the start of the current line.
<Ctrl-Home> positions the cursor at the start of the screen.
<Ctrl-End> positions the cursor at the last line of the screen.
<Space> triggers a dictionary search using the string of characters beginning
with the one marked by the cursor. (See below.)
<a> the same dictionary search as <space>, but if the search key begins with
one or more kanji characters, the search will match against any occurrence of
the character(s) among kanji compounds in the dictionary, instead of just those
at the start of compounds.
</> invokes a prompt for a string of characters, the the file is searched
forwards until a line is found containing that string. Ths scan is case
sensitive.
<l> logs the character string marked by the cursor to a file (default is
"jreader.log"). The logged data is in "edict" format, i.e. `kanji [kana]
/english .../', with the logged characte